Game Modes

CocoKOTH supports two different game modes: Capture and Score. Each mode has its own configuration options and gameplay mechanics.

Capture Mode

In Capture mode, players must stay inside the KOTH zone for a set amount of time to win. If they leave the zone, the timer can reset (configurable).

Configuration

plugins/CocoKoth/koths/my-koth.yml

mode: CAPTURE

settings:
  # Time needed to capture (in seconds)
  capture-time-seconds: 180
  
  # Reset timer when player leaves the zone?
  capture-end-reset-time: true
  
  # Maximum time the KOTH can run (-1 for unlimited)
  max-time-seconds: 7200
  
  # If max time is reached, reward current capturer?
  end-reward-capturer: false

How It Works

1. KOTH starts with /koth start <name> or a starter item
2. Player enters the zone and starts capturing
3. Timer counts down while player stays in zone
4. If player leaves (and reset is enabled), timer resets
5. First player to complete the capture time wins!

Score Mode

In Score mode, players earn points while standing in the KOTH zone. The first player/team to reach the target score wins, or the player with the most points when time runs out.

Configuration

plugins/CocoKoth/koths/my-koth.yml

mode: SCORE

settings:
  # Enable team mode (scores per team instead of per player)
  team-mode: false
  
  # Points needed to win (-1 for time-based)
  capture-time-seconds: -1
  
  # Maximum time the KOTH can run
  max-time-seconds: 1200

How It Works

1. KOTH starts with /koth start <name> or a starter item
2. Players enter the zone and earn 1 point per second
3. Scoreboard shows top players/teams
4. First to reach target score wins, OR highest score when time runs out
5. Top 3 players can receive different rewards!

Team Mode

When team-mode is enabled:

• Scores are tracked per team instead of per player
• Requires a team plugin (CocoGuild or PlaceholderAPI team)
• The last capturer from the winning team receives rewards

Comparison

Feature	Capture Mode	Score Mode
Win Condition	Hold zone for X seconds	Reach target score or highest when time ends
Multiple Winners	❌ Single winner	✅ Top 3 rewarded
Team Support	❌ Individual only	✅ Optional team mode
Timer Reset	✅ Configurable	❌ Points accumulate
Best For	Quick events	Longer competitive events

Creating a KOTH

# Create a Capture mode KOTH
/koth create spawn CAPTURE

# Create a Score mode KOTH
/koth create arena SCORE

After creating, configure the KOTH in plugins/CocoKoth/koths/<name>.yml or use /koth editor <name>.